Make intra-bank transfer

POST /api/v1/Transactions/intra-bank

Description

This endpoint is used to make intra-bank transfers.

Tags: Transactions
URL: /api/v{version}/Transactions/intra-bank
ApiKey: No API key required
Content-Type: text/plain, application/json, text/json
Parameters:

• version: string, required

• Accept-Language: header, optional, change the default response message language from English(en) to French(fr) or English(en)
  Body Parameters:

• FromAccount: string, required, the account to transfer from

• ToAccount: string, required, the account to transfer to

• Amount: number, required, the amount to transfer

• Currency: string, required, the currency of the transfer

• TransactionType: string, required, the type of the transaction

• TransactionRef: string, required, the reference of the transaction
  Response:

• Success, returns an IntraBankTransferResponseResponse.
  Error Codes:

• 400: Bad Request

• 404: Not Found

Example:
JSON

POST /api/v1/Transactions/intra-bank
{
  "FromAccount": "123456789012",
  "ToAccount": "987654321098",
  "Amount": 100.00,
  "Currency": "USD",
  "TransactionType": "Transfer",
  "TransactionRef": "123456"
}

Plain Text

HTTP/1.1 200 OK
{
  "Message": "Intra-bank transfer successful",
  "TransactionId": "1234567890",
  "FromAccount": "123456789012",
  "ToAccount": "987654321098",
  "Amount": 100.00,
  "Currency": "USD",
  "TransactionType": "Transfer",
  "TransactionRef": "123456"
}

/api/v1/Transactions/intra-bank

Headers

Content-Type	Value
Accept-Language

Headers

Content-Type	Value
Content-Type	application/json

Headers

Content-Type	Value
Accept	text/plain

Body (raw)

{
  "amount": `<double>`,
  "narration": `<string>`,
  "debitAccountNumber": `<string>`,
  "recipientAccountNumber": `<string>`,
  "reference": `<string>`
}

Response: 200

{
  "succeeded": `<boolean>`,
  "message": `<string>`,
  "errors": [
    `<string>`,
    `<string>`
  ],
  "data": {
    "amount": `<double>`,
    "fee": `<double>`,
    "currency": `<string>`,
    "status": `<string>`,
    "reference": `<string>`,
    "narration": `<string>`,
    "trnxId": `<uuid>`
  }
}

Response: 400

{
  "succeeded": `<boolean>`,
  "message": `<string>`,
  "errors": [
    `<string>`,
    `<string>`
  ],
  "data": `<string>`
}

Response: 404

{
  "succeeded": `<boolean>`,
  "message": `<string>`,
  "errors": [
    `<string>`,
    `<string>`
  ],
  "data": `<string>`
}